Solstar — Solar & Renewable Energy React Template

Built with React 19, Vite and React Router. No jQuery.

Version: 1.0.0  ·  Updated: October 2026  ·  Author: Mugli

1. Introduction

Solstar is a multi-page website template for solar, renewable-energy and green-technology companies. This package is the React edition: the original HTML design converted into reusable components, with client-side routing and a modern Vite build.

Features

2. Package contents

ItemDescription
solstar-react/The source code of the template (what you edit and build).
documentation/This documentation. Open index.html in any browser.
changelog.txtRelease history.

Run all npm commands inside the solstar-react folder.

3. Requirements

ToolVersion
Node.js20.19 or newer, or 22.12 or newer (required by Vite 8)
npm10 or newer (installed with Node.js)
Code editorAny, e.g. VS Code

Check your versions with node -v and npm -v. Download Node.js from nodejs.org.

4. Installation

1. Unzip the package and open a terminal in the solstar-react folder.

2. Install dependencies:

npm install

3. Start the development server:

npm run dev

Open the address shown in the terminal (usually http://localhost:5173). Changes you save appear instantly.

Available commands

CommandWhat it does
npm run devDevelopment server with hot reload
npm run buildCreates the production site in dist/
npm run previewServes the dist/ build locally to test it
npm run lintChecks the source code for problems

5. Project structure

solstar-react/
├── index.html              HTML shell: page meta, favicon, theme CSS links
├── vercel.json             Rewrite rule so deep links work on Vercel
├── .env.example            Environment variables (form endpoint)
├── package.json
├── vite.config.js
├── public/
│   └── assets/             Static files, served as-is
│       ├── css/            bootstrap.min.css, all.min.css (Font Awesome Free),
│       │                   animate.css, main.css (theme styles)
│       ├── images/         Template images, grouped by section
│       ├── img/            Decorative shapes
│       └── webfonts/       Font Awesome font files
└── src/
    ├── main.jsx            Entry point, imports Swiper / Splitting / Bootstrap JS
    ├── App.jsx             Route table (lazy-loaded pages)
    ├── layouts/
    │   └── MainLayout.jsx  Shared chrome: preloader, header, mobile menu, cursor, etc.
    ├── components/
    │   ├── Header.jsx, MobileMenu.jsx, Preloader.jsx
    │   ├── BackToTop.jsx, Cursor.jsx, VideoModal.jsx, FormHandler.jsx
    │   └── FooterHome1/2/3.jsx, FooterDefault.jsx
    ├── effects/
    │   └── useTemplateEffects.js   Scroll reveal, counters, progress, sliders, tilt, text split
    ├── pages/              One file per page
    └── styles/
        └── app.css         Small additions (video modal, form toast)

6. Pages & routing

URLFile
/src/pages/HomeOne.jsx
/home-twoHomeTwo.jsx
/home-threeHomeThree.jsx
/aboutAbout.jsx
/servicesServices.jsx
/service-detailsServiceDetails.jsx
/projectsProjects.jsx
/project-detailsProjectDetails.jsx
/blogBlog.jsx
/blog-detailsBlogDetails.jsx
/faqFaq.jsx
/contactContact.jsx
any other URLNotFound.jsx (404)

Use <Link to="/about"> from react-router-dom for internal links so pages change without a reload.

Adding a new page

1. Create src/pages/Pricing.jsx. Copy an existing inner page such as Faq.jsx and edit it. Keep the outer smooth-wrapper / smooth-content divs and the footer.

import FooterDefault from "../components/FooterDefault";

export default function Pricing() {
  return (
    <div className="smooth-wrapper" id="smooth-wrapper">
      <div className="smooth-content" id="smooth-content">
        {/* your sections */}
        <FooterDefault />
      </div>
    </div>
  );
}

2. Register it in src/App.jsx:

const Pricing = lazy(() => import("./pages/Pricing"));
...
<Route path="/pricing" element={<Pricing />} />

3. Add it to the menus (see Navigation menu).

Scroll animations, sliders and counters on the new page start automatically. No extra setup is needed.

7. Components

ComponentPurpose
MainLayoutWraps every page. Renders the preloader, cursor, back-to-top, form handler, header and mobile menu, and scrolls to the top on navigation.
HeaderDesktop navigation and "Get a quote" button. Gets the sticky class after 10px of scrolling.
MobileMenuSlide-in menu for small screens. Menu items are defined in a MENU array at the top of the file.
FooterHome1 / 2 / 3Footers used by Home One, Two and Three.
FooterDefaultFooter used by all inner pages.
VideoModalOpens YouTube or Vimeo links in a popup. Any link with the class popup-video opens it automatically.
FormHandlerHandles all forms. See Forms.
Preloader, Cursor, BackToTopSmall self-contained interface pieces.

8. Customization

Colors

Theme colors are CSS variables at the top of public/assets/css/main.css:

:root {
  --theme:  #004540;   /* main brand color (dark green) */
  --theme2: #FFE175;   /* accent (yellow) */
  --header: #241442;   /* dark headings / hover */
  --title:  #252525;   /* heading text */
  --text:   #525252;   /* body text */
  --orange: #F74F22;
  --bg:     #EAECF3;
  --bg2:    #EBEDE2;
  ...
}

Change a value once and it updates everywhere it is used.

Fonts

The theme uses Google Fonts: Jost, Epilogue, Poppins and Teko. They are loaded by @import lines near the top of main.css. To change a font, edit those lines and update the font-family values in the same file.

Privacy tip: Google Fonts are loaded from Google's servers. If your site needs to avoid this (for example for GDPR reasons), download the fonts and host them in public/assets/fonts.
WhatFile
Header logopublic/assets/images/logo/headerLogo1_1.png (used in Header.jsx)
Mobile menu logopublic/assets/images/logo/logo2.svg (used in MobileMenu.jsx)
Footer logopublic/assets/images/logo/footerLogo1_1.png
Faviconpublic/assets/images/favicon.png (linked in index.html)

Replace the files with your own using the same names, or change the paths in the components.

The menu exists in two places. Update both:

// MobileMenu.jsx
{ label: "Pricing", to: "/pricing" },
{ label: "Blog", submenu: [
    { to: "/blog", label: "Blog" },
    { to: "/blog-details", label: "Blog Details" },
] },

Edit the matching footer component to change text, links, address, phone, email and social icons. FooterDefault.jsx is shared by all inner pages, so one edit updates 9 pages.

Images

All images live in public/assets/images and are referenced with root paths such as /assets/images/about/aboutThumb1_1.png. Replace a file with the same name, or point the src to a new file. Keep images compressed (JPG/WebP for photos, SVG/PNG for icons) for faster loading.

Section background images are set with an inline style in the page files, for example style={{ backgroundImage: "url(/assets/images/service/serviceDetailsContactBG.jpg)" }}, or by CSS rules in main.css.

Page titles & SEO

Each page sets its browser-tab title in a useEffect at the top of the page file:

useEffect(() => {
  document.title = "About Us — Solstar React Template";
}, []);

Default meta description, author and favicon are in index.html.

This is a client-side rendered app. Search engines such as Google run JavaScript and can index it, but if SEO is critical for your project consider adding pre-rendering or moving to a framework with server rendering.

9. Animations & effects

All effects are started by useTemplateEffects() in src/effects/useTemplateEffects.js. You only add classes and attributes to your markup.

EffectHow to use
Scroll revealAdd wow plus an Animate.css class: className="wow fadeInUp". Optional delay: data-wow-delay=".3s", optional duration: data-wow-duration="1s".
Counter<span className="counters-item">250</span> counts from 0 to the number when it scrolls into view.
Progress bar<div className="progress-bar" style={{width: "75%"}} /> animates from 0 to the width.
Text split animationAdd data-splitting (with the theme's splt-txt wow classes) to a heading or paragraph.
Card tiltAdd data-tilt and optionally data-tilt-max={12} (degrees).
Video popup<a href="https://www.youtube.com/watch?v=ID" className="popup-video">
Accordion (FAQ)Bootstrap collapse: data-bs-toggle="collapse" and data-bs-target="#id".

Sliders

Any element with the classes swiper mugli-slider becomes a slider. Options are read from its data-slider-options attribute (JSON):

<div className="swiper mugli-slider"
     data-slider-options='{"loop": true, "autoplay": false,
       "breakpoints": {"0":{"slidesPerView":1},"768":{"slidesPerView":2},"1200":{"slidesPerView":3}}}'>
  <div className="swiper-wrapper">
    <div className="swiper-slide">Slide 1</div>
    <div className="swiper-slide">Slide 2</div>
  </div>
  <div className="slider-pagination"></div>
  <button className="slider-prev"></button>
  <button className="slider-next"></button>
</div>

Defaults: 1 slide, loop on, 6 second autoplay, 1 second transition. Any Swiper option can be added to the JSON. Arrows use .slider-prev / .slider-next and dots use .slider-pagination inside the slider.

10. Forms

Important: a static template has no server, so forms do not send email by themselves. By default every form runs in demo mode: it validates the fields, shows a notice and sends nothing.

To receive messages, point the forms at any service that accepts a form POST (your own backend, Formspree, Getform, Basin, etc.):

1. Copy .env.example to .env.

2. Set your URL:

VITE_FORM_ENDPOINT=https://formspree.io/f/yourFormId

3. Restart npm run dev or rebuild with npm run build.

Form fields are sent as multipart/form-data using their name attributes. A success or error message appears at the bottom of the screen. Environment variables are read at build time, so rebuild after changing them.

11. Deployment

Run npm run build. Upload the contents of the dist folder to any static host. Because the site uses client-side routing, the server must return index.html for every URL; otherwise refreshing /about gives a 404.

Vercel

Import the project (framework preset: Vite). The included vercel.json already contains the needed rewrite.

Netlify

Create public/_redirects containing:

/*  /index.html  200

Apache (.htaccess in the site root)

RewriteEngine On
RewriteBase /
RewriteRule ^index\.html$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /index.html [L]

Nginx

location / {
  try_files $uri /index.html;
}

Sub-folder hosting

If the site is not at the domain root (for example example.com/solar/), set base: "/solar/" in vite.config.js and add basename="/solar" to <BrowserRouter> in App.jsx. Image paths that start with /assets/ also need that prefix.

12. Browser support

Latest versions of Chrome, Edge, Firefox, Safari (desktop and iOS) and Android Chrome. Internet Explorer is not supported.

13. Credits & licenses

Code libraries

LibraryLicenseLink
React, React DOMMITreact.dev
React RouterMITreactrouter.com
ViteMITvite.dev
Bootstrap 5.3MITgetbootstrap.com
SwiperMITswiperjs.com
Splitting.jsMITsplitting.js.org
Animate.cssMITanimate.style

Icons

Font Awesome Free 6 — icons CC BY 4.0, font files SIL OFL 1.1, code MIT. See fontawesome.com/license/free. The template does not include Font Awesome Pro.

Fonts

Jost, Epilogue, Poppins and Teko from Google Fonts, all under the SIL Open Font License 1.1.

Images

Author to complete before submission: list the source and license of every photo, illustration and icon image in public/assets/images (for example stock site, photographer and URL). Envato requires that all images included in the download are licensed for redistribution.
Folder / fileSourceLicense
public/assets/images/…(add)(add)

14. Troubleshooting

ProblemSolution
npm install or npm run dev fails with an engine/version errorUpgrade Node.js to 20.19+ or 22.12+.
Refreshing a page like /about shows 404 on my hostAdd the rewrite rule for your server (see Deployment).
Form shows "Demo mode" messageSet VITE_FORM_ENDPOINT and rebuild (see Forms).
Changed .env but nothing happensRestart the dev server or rebuild. Variables are read at start/build time.
My new page has no animationAdd the wow class plus an Animate.css class such as fadeInUp.
A slider shows all slides in a columnCheck the markup has the swiper mugli-slider classes on the container and swiper-wrapper / swiper-slide inside.
Icons appear as squaresConfirm public/assets/webfonts exists and was uploaded to the server.
A white or empty page after deployThe site is probably in a sub-folder. See "Sub-folder hosting".

15. Changelog

Version 1.0.0 — October 2026
  - Initial release of the React edition
  - 12 pages + 404, React 19, React Router 7, Vite 8
  - jQuery removed; effects rebuilt with React and browser APIs
  - Font Awesome Pro replaced with Font Awesome Free
  - Configurable form endpoint (no third-party form action)

16. Support

Support covers questions about the template's features, reports of bugs, and help with included functionality. It does not cover custom development or third-party services.

Please contact the author through the item's comments page on the marketplace where you bought it, or the contact details on the author's profile. Include your Node.js version, the steps to reproduce the problem, and any message shown in the terminal or browser console.

If you like Solstar, a rating on the marketplace is greatly appreciated.